home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / sf2pk200.zip / PKSCALE.TXT < prev    next >
Text File  |  1992-04-15  |  16KB  |  419 lines
  1.   [This ASCII version of the documentation is provided for on-line reference]
  2.   [only, it is not intended as a substitute for the "real" documentation    ]
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                                   PKscale
  31.  
  32.              PKscale changes the magnification of TeX PK files
  33.  
  34.                                Version 1.12
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.               Copyright (c) 1991-92 by Small Planet Software
  61.  
  62.                             All Rights Reserved
  63.  
  64.  
  65.  
  66.  
  67.         THIS PROGRAM IS ABSOLUTELY FREE. THIS PROGRAM IS  PROVIDED
  68.         ``AS IS'' WITHOUT WARRANTY  OF ANY KIND, EITHER  EXPRESSED
  69.         OR  IMPLIED,  INCLUDING  BUT  NOT  LIMITED TO, THE IMPLIED
  70.         WARRANTIES   OF   MERCHANTABILITY   AND   FITNESS   FOR  A
  71.         PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY  AND
  72.         PERFORMANCE  OF  THE  PROGRAM  IS  WITH  YOU.   SHOULD THE
  73.         PROGRAM  PROVE  DEFECTIVE,  YOU  ASSUME  THE  COST  OF ALL
  74.         NECESSARY SERVICING, REPAIR OR CORRECTION.
  75.  
  76.         IN NO  EVENT WILL  ANY COPYRIGHT  HOLDER BE  LIABLE TO YOU
  77.         FOR DAMAGES,  INCLUDING ANY  GENERAL, SPECIAL,  INCIDENTAL
  78.         OR  CONSEQUENTIAL  DAMAGES  ARISING  OUT  OF  THE  USE  OR
  79.         INABILITY TO  USE THE  PROGRAM (INCLUDING  BUT NOT LIMITED
  80.         TO  LOSS  OF  DATA  OR  DATA  BEING RENDERED INACCURATE OR
  81.         LOSSES SUSTAINED BY YOU OR  THIRD PARTIES OR A FAILURE  OF
  82.         THE PROGRAM TO OPERATE  WITH ANY OTHER PROGRAMS),  EVEN IF
  83.         SUCH  HOLDER  OR  OTHER  PARTY  HAS  BEEN  ADVISED  OF THE
  84.         POSSIBILITY OF SUCH DAMAGES.
  85.  
  86.   Every reasonable effort has been made to assure the quality and
  87.   completeness of this program, if you have any questions, comments, or
  88.   suggestions or if you believe that you have found a bug please contact
  89.   the author at the address given at the end of this document.
  90.  
  91.   All trademarks used within this document are trademarks of their
  92.   respective owners.
  93.  
  94.  
  95. Changes (what's new and exciting)
  96. ---------------------------------
  97.  
  98. Version 1.12
  99.  
  100.  o More minor documentation changes
  101.  
  102. Version 1.11
  103.  
  104.  o Minor documentation changes
  105.  
  106. Version 1.1
  107.  
  108.  o Initial release
  109.  
  110.  o Added abbreviations for common \magsteps Version 1.0a,b
  111.  
  112.  o Beta test releases
  113.  
  114. Usage
  115. -----
  116.  
  117. PKscale's name may be misleading. PKscale changes some of the internal
  118. values in the PK file to make TeX believe that the font is a scaled version
  119. of some other font; however, PKscale does not, and cannot, change the
  120. actual size of the bitmapped characters in the font. For a better idea of
  121. how PKscale can be used, and what it actually does, consult the ``Learning
  122. by Example'' and ``What's Really Going On'' sections below. If you really
  123. want to resize bitmapped fonts, you can use Small Planet Software's Sfware
  124. package to accomplish the task. To resize TeX fonts, you will also need
  125. PKtoSFP and SFPtoPK.
  126.  
  127. PKscale is run from the DOS command prompt. In order to keep the program
  128. small and simple, a command-line interface has been chosen instead of
  129. something more user-friendly. The general format for running PKscale looks
  130. like this:
  131.  
  132.   PKSCALE pkfile[.pk] <tfmfile[.tfm]> </option1:value1> ... </optionn:valuen>
  133.  
  134. Where:
  135. ------
  136.  
  137.  pkfile[.pk]    is the name of the TeX PK file.
  138.  
  139.  tfmfile[.tfm]  is the name of the TeX TFM file. If no path is given,
  140.                 PKscale will search the tfmpath specified in the
  141.                 configuration file.By default, PKscale will use the root
  142.                 name of the PK file as the root name for the TFM file (i.e.
  143.                 the default TFM file when converting D:\PATH\MYPKFILE.PK is
  144.                 MYPKFILE.TFM). PKscale needs the TFM file in order to
  145.                 convert the PK file.
  146.  
  147.  /option:value  is one of the following options: /designsize, /scale, or
  148.                 /threshold.  These options allow you to specify what scale
  149.                 of PK file to create and how large an error to allow before
  150.                 printing a warning message.
  151.  
  152. Options
  153. -------
  154.  
  155. /designsize:size
  156. ----------------
  157.  
  158. The /designsize option sets the design size of the PK font (in points).
  159. This value should reflect the base size of the font that you are
  160. scaling.For example, if you are creating a PK file that is a scaled version
  161. of CMR12, the design size is 12pt (you should specify /designsize:12).
  162.  
  163. /scale:scalefactor
  164. ------------------
  165.  
  166. The /scale option sets the scaling factor of the PK file. PKscale
  167. determines this value based upon information in the PK file and the
  168. requested /designsize, however, the computed value may not match the
  169. desired scale precisely.This can be caused, for example, by rounding errors
  170. in the conversion of a softfont file to a PK file by SFPtoPK. You should
  171. not use the /scale option to make gross changes in the scale factor since
  172. it is bound to produce an ugly, poorly spaced font.
  173.  
  174. The /scale option accepts MAGSTEPHALF (or simply H), MAGSTEP1...MAGSTEP5,
  175. and scale values of less than 10 as abbreviations for standard \magstep
  176. sizes.
  177.  
  178. /threshold:pixelcount
  179. ---------------------
  180.  
  181. The /threshold value adjusts PKscale's sensitivity to errors. If the
  182. difference between the character width in the PK file and the character
  183. width information in the TFM file is larger than the /threshold value, a
  184. warning message will be printed.
  185.  
  186. Learning by Example
  187. -------------------
  188.  
  189. If it is not immediately obvious how PKscale works, have no fear; a few
  190. examples should make it much clearer.
  191.  
  192. The examples that follow concentrate on making PK files in one or more of
  193. the standard \magstep sizes. Keep in mind that these are not sacred sizes,
  194. PKscale will allow you to create fonts that are scaled by any amount.If the
  195. concept of a scaled font is not clear, you might want to re-read chapter 4
  196. of the TeXbook as a refresher.
  197.  
  198. Both of these examples assume that you are creating PK files from softfonts
  199. using the SFPtoPK program and that it is the PK files produced by SFPtoPK
  200. that you are scaling. This is by no means the only use for PKscale but it
  201. is the only use that I have ever encountered. Sure, you could use PKscale
  202. to create a version of CMR5 scaled 2000 from CMR10, but what would be the
  203. point?
  204.  
  205. In the first example, suppose that we have HP Type Director or ZSoft
  206. TypeFoundry, or some other program capable of creating softfont files from 
  207. scaleable outline fonts. Our task is to produce a group of PK files that 
  208. represent a 10pt font scaled to all of the standard \magsteps.
  209.  
  210. Begin by creating softfont files at the following sizes: 10pt, 10.95pt, 
  211. 12pt, 14.4pt, 17.28pt, 20.74pt, and 24.88pt. These softfonts represent the 
  212. original 10pt font at each of the standard \magsteps (i.e. a 10pt font at 
  213. \magstep1 is 1:2 times as large so it's a 12pt font, a 10pt font at 
  214. \magstep2 is 1:22 times as large so it's a 14.4pt font, etc).
  215.  
  216. Next, convert the 10pt font into a PK file with SFPtoPK and convert the PL 
  217. file created by SFPtoPK into a TFM file with the standard TEXware utility 
  218. PLtoTF. The documentation included with SFPtoPK describes in greater detail 
  219. how to convert softfonts into PK files. Now you have your 10pt font at 
  220. \magstep0 completed.Move the PK file to wherever you keep your \magstep0 PK 
  221. fonts and move the TFM file to wherever you keep your TFM files.
  222.  
  223. Convert the remaining softfonts into PK files with SFPtoPK but discard the 
  224. PL files since these fonts won't have TFM files of thier own.
  225.  
  226. Beginning with the 12pt font, run PKscale to create the scaled PK file.  
  227. The command-line for PKscale will look like this:
  228.  
  229.     PKSCALE pkfile tfmfilefrom10ptfont /designsize:10 /scale:magstep1
  230.  
  231. The pkfile specified above will now be recognized by T sion of the 10pt 
  232. font at \magstep1. The last thing you EXmusast ado scaledbefver-ore you can 
  233. use the font is rename it to the same name as your 10pt font and move it to 
  234. wherever you keep your \magstep1 font files.
  235.  
  236. Convert the remaining PK files with PKscale, moving each scaled PK file the 
  237. the appropriate directory for your implementation of TEX. When you have